Inside Macintosh: QuickDraw GX Objects /

Chapter 7 - View-Related Objects / View-Related Objects Reference

View Port Functions / Manipulating View Port Object Properties

GXSetViewPortChildren

You can use the GXSetViewPortChildren function to assign a list of child view ports to a view port object.

void GXSetViewPortChildren(gxViewPort target, long count, 
                         const gxViewPort list[]);

target

A reference to the view port whose children you wish to set.

count

The number of references in the child view port list.

list

The array of view port references that is the new child view port list.

DESCRIPTION

The GXSetViewPortChildren function sets each of the view ports specified in the list parameter to have the target view port as its parent, and assigns the list as the child view port list of the target view port. Previous children of the target view port are assigned to have no parent.

If the target parameter is set to nil, each view port in the list is assigned to have no parent. If a child view port in the list is in a different view group than the target view port's view group, the child view port is changed to be in the view group of the target view port.

SPECIAL CONSIDERATIONS

View port hierarchies cannot contain circular references; that is, a view port cannot have itself or any of its ancestors as its child.

The view ports in a hierarchy must all be in the same view group.

ERRORS, WARNINGS, AND NOTICES

Errors
invalid_viewPort_reference
viewPort_cannot_contain_itself	(debugging version)

SEE ALSO

For information about view port hierarchies and the child view port list property, see "Parent and Child View Ports" beginning on page 7-18.

To get the child view port list of a view port, use the GXGetViewPortChildren function, described in the previous section.

To get the parent of a view port, use the GXGetViewPortParent function, described on page 7-84. To set the parent of a view port, use the GXSetViewPortParent function, described on page 7-84.